home *** CD-ROM | disk | FTP | other *** search
/ Grand Slam 3 / Grand Slam 3.iso / 023 / oplay100.arj / OMNIPLAY.DOC < prev    next >
Text File  |  1995-03-11  |  15KB  |  305 lines

  1.  
  2.                                 OmniPlayer v1.00
  3.  
  4.                           (c) 1993-95, Edward Schlunder
  5.                                All Rights Reserved
  6.  
  7.                          Zilym Limms of OverThrowMachine
  8.                               zilym@hndymn.stat.com
  9.  
  10.    Contents:
  11.             1 . . Introduction
  12.             2 . . OmniPlayer Usage
  13.             3 . . Internal Modules
  14.             4 . . Implementation List
  15.             5 . . Greetings
  16.             6 . . Beta Testing Team
  17.             7 . . Disclaimer
  18.             8 . . Closing Notes
  19.  
  20.             OP  is  a multiformat digital  music  player for your 386+
  21.       computer. If you find any bugs or other anomalies, please get in
  22.       contact  with  us  so  that it  will  get  fixed for the future.
  23.  
  24.             If  you  find  a module  format  that OP doesn't currently
  25.       support  or doesn't play correctly, please contact us so that it
  26.       can  be  added!!  We intend to  make  OP support as many modules
  27.       formats as they are available!
  28.  
  29.             In addition, if you find this program useful in any way,
  30.       *please* send a short piece of email or snail mail to the author
  31.       so that I will know how much this program is really being used
  32.       and whether it is worth the trouble of continuing it.
  33.  
  34.               email: zilym@hndymn.stat.com
  35.  
  36.          snail mail: Edward  Schlunder
  37.                      554 N. Acacia Road
  38.                      Apache Junction, Arizona 85219-4313
  39.                      USA
  40.  
  41.     latest versions: ftp.eng.ufl.edu      /demos/music/programs/players
  42.                      ftp.vt.edu           /pub/otm
  43.  
  44.                              ────────────────────────
  45.                                  OmniPlayer Usage
  46.  
  47.       OP filespec [options]
  48.  
  49.       filespec               File to play.. Extension not required
  50.       options        -EMS    Force EMS use (even if not detected)
  51.                      -NOEMS  Disables EMS use (even when detected)
  52.                      -F      Use Foreground mixing
  53.                              This is mainly only useful when playing
  54.                              under Windows or DesqView. It seems to
  55.                              help Windows steady the mouse a bit.
  56.                      -L      Disallow any module looping. When the
  57.                              modules stops, exit OmniPlayer. Useful
  58.                              in batch files.
  59.       [0]            -Ax     Amplification           (x=0 to 9)
  60.                              Note that too high a value will cause
  61.                              clicks and cracks, way high values
  62.                              produce pure trash. Use very small
  63.                              numbers in most cases (1 or 2)
  64.       [4024 Bytes]   -Bxxxxx Buffer Size             (x=256 to 32767)
  65.       [Max of Dev]   -Sxx    xxKHz oversampling rate (x=5KHz to 45KHz)
  66.       [Autodetect]   -Ixx    Device IRQ number
  67.       [Autodetect]   -Dx     Device DMA channel
  68.       [Autodetect]   -Pxxx   Device Base I/O Address (x=xxxh)
  69.                      -Cx     Select Output Device    (x=device number)
  70.                              No: Sound Card:
  71.                               0  Gravis Ultrasound
  72.       [Default]               1  Sound Blaster 1.xx
  73.                               2  Sound Blaster 2.xx
  74.                               3  Sound Blaster Pro
  75.                               4  Sound Blaster 16
  76.                               5  Pro AudioSpectrum
  77.                      -Vx     Visual Display Mode     (x=display number)
  78.                              No: Name:
  79.                               1  Help
  80.                               2  Scope(s)
  81.       [Default]               3  VU Meters
  82.                               4  Sample List
  83.       [Offset 0]     -Oxxxxx Load module from file
  84.                              offset x (see section
  85.                              below)
  86.  
  87.       Example:
  88.  
  89.       C:\SOUND\OP>OP DEAF -C3 [enter]   <- Plays the example module in
  90.                                            stereo on a SBPro
  91.  
  92.                              ────────────────────────
  93.                                  Internal Modules
  94.  
  95.             OmniPlayer  has  a  neat little  feature  to help you play
  96.       modules  from  inside demos and games.  This section will try to
  97.       explain how to use this feature.
  98.  
  99.             Included  with OmniPlayer is a  small utility to scan EXEs
  100.       for  modules  within  (MODSCAN.EXE).  MODSCAN  only  checks  for
  101.       specail  module signatures, so module formats without signatures
  102.       can  not  be detected (ie, 15  instrument MODs). In addition, if
  103.       the  EXE  is  compressed with  PKLite  or  a similar compression
  104.       program, MODSCAN won't be able to read the signatures that might
  105.       be  present.  Use UNP (not  included) or another similar utility
  106.       for uncompressing EXEs so that they can be scanned.
  107.  
  108.             Okay,  the first thing you need  to do now that you've got
  109.       an  EXE file with an embedded  module unpacked, you need to find
  110.       out  what  offset(s)  into the file  are  the locations for your
  111.       modules.
  112.  
  113.       Use:     MODSCAN filename [Enter]
  114.       Example:
  115.       C:\DEMOS>MODSCAN PANIC.EXE
  116.       Internal Module Scanner            Version x.xx
  117.       By Edward Schlunder                     (C)1994
  118.  
  119.                55076  S3M
  120.       Scan complete
  121.  
  122.             This  first column lists the  module's title (if any), the
  123.       second  is the modules offset, and  the last is the module type.
  124.       Generally,  if  a module has a  title filled with garbage, it is
  125.       probably not a module and shouldn't try to play it (would result
  126.       in crashing OP possibly).
  127.  
  128.             To actually play the module we type:
  129.  
  130.       Use:     OP filename.EXE -Ooffset [Enter]
  131.       Example:
  132.       C:\DEMOS>OP PANIC.EXE -o55076
  133.  
  134.             Once  that's  done,  OmniPlayer will  attempt  to load the
  135.       specified  module  at the offset it  was told. Note that the EXE
  136.       extension  is  required because we  wouldn't want to try loading
  137.       EXEs  as  15 instrument MOD files  during normal usage now would
  138.       we?
  139.  
  140.                               ──────────────────────
  141.                                Implementation  List
  142.  
  143.    Key:
  144.    ■ Implementation completed
  145.    · Implementation incomplete
  146.      Not implemented at all
  147.  
  148.                                 ──────────────────
  149.                              ──═══ File Formats ═══──
  150.                                 ──────────────────
  151. >>>MOD/OCT/WOW  ■Protracker variants                                  4..32
  152.  
  153.   ■0xx Arpeggio/None        ■Bxx Order Jump            ■E7x Tremolo Control
  154.   ■1xx Porta Up             ■Cxx Set Volume            ■E8x Set Pan
  155.   ■2xx Porta Down           ■Dxx Pattern Break         ■E9x Retrigger Note
  156.   ■3xx Porta Note           ■Fxx Set Tempo/BPM         ■EAx Fine Vol Up
  157.   ■4xy Vibrato               E0x Filter On/Off         ■EBx Fine Vol Down
  158.   ■5xy Porta Note+Vol Slide ■E1x Fine Porta Up         ■ECx Note Cut
  159.   ■6xy Vibrato+Vol Slide    ■E2x Fine Porta Down       ■EDx Note Delay
  160.   ■7xy Tremolo               E3x Glissando Control     ·EEx Pattern Delay
  161.   ·8xx Set Pan/Surround     ■E4x Vibrato Control       ■EFx Invert Loop
  162.   ■9xx Sample Offset        ■E5x Set Finetune
  163.   ■Axy Volume Slide         ■E6x Pattern Loop
  164.  
  165. >>>MED          ■MED Editor/OctaMED Pro                                   4
  166.   ■0xy Arpeggio/None         Exx Synth Jump           ■11xx Fine Porta Up
  167.   ■1xx Porta Up             ■F00 Pattern Break        ■12xx Fine Porta Down
  168.   ■2xx Porta Down            Fxx Set BPM              ■14xy Vibrato
  169.   ■3xx Porta to Note         FF1 Play 2*Row           ■150x Set Finetune
  170.    4xy PT v1.0 Vibrato       FF2 Delay Row/2          ■16xx Pattern Loop
  171.   ■5xy Porta Note+Vol Slide  FF3 Play 3*Row           ■18xx Note Cut
  172.   ■6xy Vibrato+Vol Slide     FF8 Filter Off           ■19xx Sample Offset
  173.   ■7xy Tremolo               FF9 Filter On            ■1Axx Fine Vol Up
  174.    8xy Set Hold/Decay        FFA MIDI Hold Pedal On   ■1Bxx Fine Vol Down
  175.   ■9xx Set Tempo             FFB MIDI Hold Pedal Off   1Cxx Change MIDI Preset
  176.   ■Axy Volume Slide          FFD Change Note          ■1Dxx Pattern Break
  177.   ■Bxx Order Jump           ■FFE Stop Song            ·1Exx Pattern Delay
  178.   ■Cxx Set Volume           ■FFF Note Cut              1Fxy Delay+Retrigger
  179.   ■Dxy Volume Slide         10xx Send MIDI Message
  180.  
  181.  
  182. >>>STM          ■Scream Tracker 2.x                                       4
  183. >>>S3M          ■Scream Tracker 3.x                                   1..16
  184.  
  185.   ■Axx Set Tempo            ■Gxx Porta Note            ■S3x Vibrato Control
  186.   ■Bxx Order Jump           ■Hxy Vibrato               ■S4x Tremolo Control
  187.   ■Cxx Pattern Break         Ixy Tremor                ■S8x Set Pan
  188.   ■Dxy Volume Slide         ■Jxy Arpeggio              ■SBx Pattern Loop
  189.   ■DFx Vol Slide Down       ■Kxy Vibrato+Vol Slide     ■SCx Note Cut
  190.   ■DxF Vol Slide Up         ■Lxy Porta Note+Vol Slide  ■SDx Note Delay
  191.   ■Exx Porta Down           ■Oxx Sample Offset         ·SEx Pattern Delay
  192.   ■EFx Fine Porta Down      ■Qxy Retrigger+Vol Slide   ■SFx Invert Loop
  193.   ■EEx Xtra Fine Porta Down ■Rxy Tremolo               ■Txx Set BPM
  194.   ■Fxx Porta Up              S0x Filter On/Off         ■Vxx Set Global Volume
  195.   ■FFx Fine Porta Up         S1x Glissando Control
  196.   ■FEx Xtra Fine Porta Up   ■S2x Set Finetune
  197.  
  198. >>>ULT          ■UltraTracker v1.0 to v1.5                            1..32
  199.  
  200.   ■1xx Porta Up             ■B0y Set Pan               ■E2y Fine Porta Down
  201.   ■2xx Porta Down           ■Cxx Set Volume            ■E9y Retrigger
  202.   ■3xx Porta Note           ■Dxx Pattern Break         ■EAy Fine Vol Up
  203.   ■4xy Vibrato              ■Fxx Set Tempo/BPM         ■EBy Fine Vol Down
  204.    501 Forwards/No Loop     ■E0y Vibrato Depth         ■ECy Note Cut
  205.    502 Backwards/No Loop    ■E1y Fine Porta Up         ■EDy Note Delay
  206.   ■Axy Volume Slide
  207.  
  208. >>>MTM          ■MultiTracker                                         1..32
  209.  
  210.   ■0xx Arpeggio/None        ■Bxx Order Jump            ■E7x Tremolo Control
  211.   ■1xx Porta Up             ■Cxx Set Volume            ■E8x Set Pan
  212.   ■2xx Porta Down           ■Dxx Pattern Break         ■E9x Retrigger Note
  213.   ■3xx Porta Note           ■Fxx Set Tempo/BPM         ■EAx Fine Vol Up
  214.   ■4xy Vibrato               E0x Filter On/Off         ■EBx Fine Vol Down
  215.   ■5xy Porta Note+Vol Slide ■E1x Fine Porta Up         ■ECx Note Cut
  216.   ■6xy Vibrato+Vol Slide    ■E2x Fine Porta Down       ■EDx Note Delay
  217.   ■7xy Tremolo               E3x Glissando Control     ·EEx Pattern Delay
  218.   ·8xx Set Pan/Surround     ■E4x Vibrato Control       ■EFx Invert Loop
  219.   ■9xx Sample Offset        ■E5x Set Finetune
  220.   ■Axy Volume Slide         ■E6x Pattern Loop
  221.  
  222. >>>669          ■Composer 669/Unis 669                                    8
  223.  
  224.   ·Ax  Porta Up             ·Dx  Frequency Adj.         G0  Pan Left
  225.   ·Bx  Porta Down           ·Ex  Vibrato                G1  Pan right
  226.   ·Cx  Porta Note           ■Fx  Set Tempo             ·Hx  Retrigger
  227.  
  228. >>>FAR          ■Farandole Composer                                      16
  229.  
  230.   ·1x  Porta Up             ■8x  Fine Volume Down      ■Fx  Set Tempo
  231.   ·2x  Porta Down            9x  Sustained Vibrato
  232.   ·3x  Porta Note            Ax  Slide to Volume
  233.   ·4x  Retrigger            ■Bx  Set Pan
  234.   ■5x  Vibrato Depth         Cx  Sample Offset
  235.   ■6x  Vibrato               Dx  Fine Tempo Down
  236.   ■7x  Fine Volume Up        Ex  Fine Tempo Up
  237.  
  238.                                 ───────────────────
  239.                              ──═══ Sound Devices ═══──
  240.                                 ───────────────────
  241. >>>GUS.MSE      ■Gravis UltraSound                             Stereo 44KHz
  242. >>>SB1X.MSE     ■Sound Blaster 1.xx                            Mono   21KHz
  243. >>>SB2X.MSE     ■Sound Blaster 2.xx                            Mono   43KHz
  244. >>>SBPRO.MSE    ■Sound Blaster Pro                             Stereo 22KHz
  245. >>>SB16.MSE     ■Sound Blaster 16                              Stereo 45KHz
  246. >>>PAS.MSE      ■Pro AudioSpectrum                             Stereo 45KHz
  247.  
  248.                                  ─────────────────
  249.                                 !!! PROGRAMMERS !!!
  250.  
  251.               Are you writing a game or demo, and you need a sound
  252.         system for it?? Please contact me! I have released my
  253.         music/sound engine to programmers as another package,
  254.         BWSBxxx.ZIP! D/l it and check it out. It's fully usable and
  255.         testable. Yes, it is shareware, but you don't have to register
  256.         if all you're making is a freeware program.
  257.  
  258.               BWSBxxx.ZIP can be found on hornet.eng.ufl.edu in
  259.          /demos/code/sound and on x2ftp.oulu.fi in
  260.          /pub/msdos/programming/mxlibs. The current version of BWSB
  261.          works with Borland C/C++, Turbo C/C++, Turbo Pascal,
  262.          PowerBasic, QuickBasic, and PDS. It uses many features that
  263.          OmniPlayer has.
  264.  
  265.                              ────────────────────────
  266.                                  Greetings go to:
  267.                          (in no particular order - relax)
  268.                          
  269.    Clint Holeman      MiKiEx            FlexRom        Dan Wilson
  270.    Renaissance        Zep               Funk e         Bob Beard
  271.    WildCat            GodHead           Leviathan      Julianne Fraser
  272.    Sonic PC           Zab               Hadji!         The rest of drama
  273.    Phil Inch          Quarex            Sam            Zer0
  274.    Stalker/OTM        Tek/OTM           Spiff          Cerulean
  275.    Phred/OTM          Hurricane/OTM     Stix           Liz Mills
  276.    Voltaire/OTM       Supreme/OTM       e-dan          Christy
  277.    NameShift/OTM      Brook             Kris McFair
  278.  
  279.          And anyone else I've spoken to in the last 2 years (the time
  280.          used to program OmniPlayer)
  281.  
  282.                                 ──────────────────
  283.                                     Disclaimer
  284.  
  285.             In  no  event  shall the authors  of  this program be held
  286.       responsible for any undesired effects caused by this program. If
  287.       something  should go wrong, it is your problem, not ours. Use at
  288.       your own risk!
  289.  
  290.                                  ─────────────────
  291.                                    Closing Notes
  292.  
  293.           Whohoahohoaoha! OmniPlayer's so cool there's nothing left to
  294.         do with it except totally rewrite it!!! Heheheheh... By the way
  295.         everybody, yes, I *am* 15 years old.. Hohohohohoh! Drama Rules!
  296.         Hey, do you have some extra hardware or cash laying around?????
  297.         Send it to me!! I need a WSS or AudioTrix Pro guys! An SBAWE32
  298.         wouldn't be bad either.. How about LPT DACs?? Yes!
  299.  
  300.           But yes, we must rewrite, in C/C++! Protected Mode OP! We need
  301.         XM playing!
  302.  
  303.           Spam forever!
  304.  
  305.         Zilym Limms/OTM